home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / pxfgetgrnam.z / pxfgetgrnam
Encoding:
Text File  |  1998-10-30  |  4.1 KB  |  97 lines
  1. PXFGETGRNAM(3F)                                        Last changed: 1-6-98
  2.  
  3.  
  4. NNAAMMEE
  5.      PPXXFFGGEETTGGRRNNAAMM - Gets group information using the group name
  6.  
  7. SSYYNNOOPPSSIISS
  8.      SSUUBBRROOUUTTIINNEE PPXXFFGGEETTGGRRNNAAMM ((_n_a_m_e,, _i_l_e_n,, _j_g_r_o_u_p,, _i_e_r_r_o_r))
  9.      CCHHAARRAACCTTEERR*_n _n_a_m_e
  10.      IINNTTEEGGEERR _i_l_e_n,, _j_g_r_o_u_p,, _i_e_r_r_o_r
  11.  
  12. IIMMPPLLEEMMEENNTTAATTIIOONN
  13.      UNICOS, UNICOS/mk, and IRIX systems
  14.  
  15. SSTTAANNDDAARRDDSS
  16.      IEEE standard interface for FORTRAN 77
  17.  
  18. DDEESSCCRRIIPPTTIIOONN
  19.      On IRIX systems, this routine is in lliibbffoorrttrraann..ssoo which is linked by
  20.      default when compiling programs with the MIPSpro 7 Fortran 90 compiler
  21.      or when compiling programs with the --ccrraayylliibbss option to the MIPSpro
  22.      7.2 F77 compiler.
  23.  
  24.      The PPXXFFGGEETTGGRRNNAAMM routine uses the ggeettggrrnnaamm(3C) function to obtain group
  25.      information using a group name.
  26.  
  27.      The following are components of the group structure used by
  28.      PPXXFFGGEETTGGRRNNAAMM and created by calling PPXXFFSSTTRRUUCCTTCCRREEAATTEE:
  29.  
  30.      * ggrr__nnaammee: Group name
  31.  
  32.      * ggrr__ggiidd:  Group ID
  33.  
  34.      * ggrr__nnmmeemm: Number of group members contained in ggrr__mmeemm
  35.  
  36.      * ggrr__mmeemm:  Array of group members' login names
  37.  
  38.      The ggrr__nnaammee component can be accessed by calling PPXXFFSSTTRRGGEETT(3F).
  39.      ggrr__ggiidd and ggrr__nnmmeemm can be accessed by calling PPXXFFIINNTTGGEETT(3F).
  40.      PPXXFFEESSTTRRGGEETT can be used to access the elements of ggrr__mmeemm.
  41.  
  42.      When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
  43.      UNICOS, UNICOS/mk, or IRIX systems, all arguments must be of default
  44.      kind unless documented otherwise.  On UNICOS and UNICOS/mk, default
  45.      kind is KKIINNDD==88 for integer, real, complex, and logical arguments; on
  46.      IRIX, the default kind is KKIINNDD==44.
  47.  
  48.      The following is a list of valid arguments for this routine:
  49.  
  50.      _n_a_m_e      An input character character variable or array element
  51.                containing the group name for which group information is
  52.                requested.
  53.  
  54.      _i_l_e_n      An input integer variable containing the length of _n_a_m_e.  If
  55.                _i_l_e_n is zero, trailing blanks are stripped.
  56.  
  57.      _j_g_r_o_u_p    An output handle of type ggrroouupp created with
  58.                PPXXFFSSTTRRUUCCTTCCRREEAATTEE(3F).
  59.  
  60.      _i_e_r_r_o_r    An output integer variable that contains zero if group
  61.                information was retrieved or nonzero if PPXXFFGGEETTGGRRNNAAMM was not
  62.                successful.
  63.  
  64.      The PPXXFFGGEETTGGRRNNAAMM routine may also return any of the following error
  65.      values:
  66.  
  67.      EENNOOEENNTT    If _n_a_m_e contains a non-existant group ID.
  68.  
  69.      EENNOOMMEEMM    If memory needed by PPXXFFGGEETTGGRRNNAAMM could not be allocated.
  70.  
  71.      EEIINNVVAALL    If _i_l_e_n < 0 or _i_l_e_n > LLEENN((_n_a_m_e))..
  72.  
  73.      EEBBAADDHHAANNDDLLEE
  74.                If _j_g_r_o_u_p is an invalid handle or has an incorrect handle
  75.                type (UNICOS and UNICOS/mk systems only).
  76.  
  77. EEXXAAMMPPLLEESS
  78.      In this example, PPXXFFGGEETTGGRRNNAAMM is called for information about the group
  79.      uusseerrss.
  80.  
  81.           program pxftest
  82.           integer jgroup
  83.           integer ierror, igid
  84.  
  85.           CALL PXFGETGRNAM('users',0,jgroup,ierror)
  86.           CALL PXFINTGET(jgroup,'gr_gid',igid,ierror)
  87.           print *,'group ID for group users is ',igid
  88.  
  89.           end
  90.  
  91. SSEEEE AALLSSOO
  92.      PPXXFFIINNTTGGEETT(3F), PPXXFFSSTTRRGGEETT(3F)
  93.  
  94.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-
  95.      2165, for the printed version of this man page.
  96.  
  97.